/**
 * <h3>ICooperationService</h3>
 * <p> 文创合作管理服务接口 </p>
 *
 * <h3>功能描述</h3>
 * <p> 定义文创合作信息增删改查等基础业务操作，供实现类完成具体数据库交互逻辑 </p>
 * <p> 接口基于 MyBatis Plus 的 {@link IService} 扩展，统一规范数据访问层行为 </p>
 *
 * <h3>元数据</h3>
 * <ul>
 *    <li> 作者：郭强 </li>
 *    <li> 创建日期：2025年05月17日 14:30:39 </li>
 * </ul>
 *
 * <h3>其他信息</h3>
 * <ul>
 *    <li> 参考链接：<a href="https://example.com">官方网页</a></li>
 *    <li> 示例代码：{@code new ICooperationService()} </li>
 * </ul>
 *
 * @apiNote 接口方法需保证事务一致性与线程安全；实际实现应避免直接new
 * @implSpec 继承自 {@link IService<CooperationDTO>}，扩展了按条件查询、按ID获取等方法
 * @since 1.0.0
 */

package com.dnndo.system.service;

import com.baomidou.mybatisplus.extension.service.IService;
import com.dnndo.system.domain.Cooperation;
import com.dnndo.system.domain.dto.CooperationDTO;

import java.util.List;

/**
 * 文创合作服务接口
 */
public interface ICooperationService extends IService<CooperationDTO> {

    /**
     * 根据条件分页查询文创合作列表
     *
     * @param dto 查询条件封装对象
     * @return List<Cooperate> 符合条件的文创合作信息列表
     */
    List<Cooperation> selectCooperationList(CooperationDTO dto);

    /**
     * 根据文创合作ID获取详细信息
     *
     * @param cooperateId 文创合作唯一标识符
     * @return Cooperate 包含文创合作详细信息的数据对象
     */
    CooperationDTO selectCooperationById(Long cooperateId);

    /**
     * 修改已有文创合作信息
     *
     * @param cooperateDTO 包含更新字段的文创合作数据对象
     * @return int 受影响的数据库记录数，用于判断操作是否成功
     */
    int updateCooperationById(CooperationDTO cooperateDTO);

    /**
     * 新增文创合作信息
     *
     * @param cooperateDTO 包含新增字段的文创合作数据对象
     * @return int 受影响的数据库记录数，用于判断操作是否成功
     */
    int insertCooperation(CooperationDTO cooperateDTO);

    /**
     * 删除指定ID的文创合作信息
     *
     * @param cooperateId 要删除的文创合作唯一标识符
     * @return int 受影响的数据库记录数，用于判断操作是否成功
     */
    int deleteCooperationById(Integer cooperateId);
}
